home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d27 / dspsrcdr.arc / DSPSRCDR.DOC < prev    next >
Text File  |  1991-12-04  |  5KB  |  128 lines
  1.                  DISPLAY SOURCE DIRECTORY COMMAND -- DSPSRCDIR
  2.                             A IBM SYSTEM/38 COMMAND
  3.  
  4.                                    Written By
  5.  
  6.                                    Joe Bolen
  7.  
  8.  
  9.  
  10.  
  11.  
  12.                    (C) - Copyright 1988 By Shaw-Barton, Inc.
  13.                                545 Walnut Street
  14.                               Coshocton, OH  43812
  15.                                Ph. (614) 622-4422
  16.                                FAX (614) 622-5868
  17.          
  18.          Limited permission is granted for use of Display Source 
  19.          Directory Command for non-commercial purposes.  Selling of 
  20.          this document and programs is strictly forbidden.
  21.  
  22.  
  23.          I.  General Overview.
  24.  
  25.          The Display Source Directory Command provides a simple 
  26.          selection and reformatting of member list information provided 
  27.          by the IBM supplied Display File Description Command (DSPFD 
  28.          TYPE(*MBRLIST).  The Command allows for generic or wildcard 
  29.          search criteria of source code type and member name prefix to 
  30.          assist in finding related source code.  The output report 
  31.          contains source code information, such as, member name, 
  32.          creation and change dates, brief description, and SEU code 
  33.          type.
  34.  
  35.  
  36.          II.  Files needed for Command.
  37.  
  38.          Four source code files are needed to create DSPSRCDIR 
  39.          command:
  40.  
  41.                    System/38 Name         P.C. Archived Name
  42.                    --------------         ------------------
  43.  
  44.                    DSPSRCDIR  (CMD)       DSPSRCDR.CMD
  45.                    DSPSRCDIR1 (CLP)       DSPSRCDR.CLP
  46.                    DSPSRCDIR2 (RPG)       DSPSRCDR.RPG 
  47.                    DSPSRCDR   (PRTF)      DSPSRCDR.PRT
  48.          
  49.          In addition, this document, archived under the name of 
  50.          DSPSRCDR.DOC, also should be tranferred to the System/38 for 
  51.          later reference.
  52.  
  53.  
  54.          III.  How to Use Display Source Code Directory Command.
  55.  
  56.          After compiling the source code, type DSPSRCDIR and prompt on 
  57.          the command.  The below figure (Fig. 1) is the prompted 
  58.          DSPSRCDIR screen.
  59.  
  60.  
  61.  
  62.                 Display Source Directory (DSPSRCDIR) Prompt
  63.          Enter the following:
  64.          Source Type:                     TYPE       P   *RPG
  65.          Member Name- Generic*:           MBR        P   *ALL 
  66.          Source file name- Generic*:      FILE       P   QRPGSRC 
  67.          Library name:                                   *USRLIBL
  68.          Output option (* or *Print):     OUTPUT     P   *
  69.  
  70.  
  71.  
  72.                                      Fig. 1
  73.          
  74.  
  75.          Source Type may be any SEU type or you may select *ALL.  
  76.          Member Name defaults to *ALL, but you may choose to enter the 
  77.          exact name or the beginning characters of a member name 
  78.          follow by the asterisk.  For example, to find all your payroll 
  79.          source code which begins with 'PR', enter 'PR*'.
  80.  
  81.          The Source file name should be related to the source type 
  82.          search criteria.  For RPG source code the programmer's memu 
  83.          defaults to QRPGSRC, CLP code to QCLSRC, etcetera. (See IBM 
  84.          System/38 Source Entry Utility Reference Manual and User's 
  85.          Guide: EDTSRC Command Parameter Description.)  Note, however, 
  86.          that you can choose any file name or generic file name for your 
  87.          search.
  88.          
  89.          The Library name should be designated to limit the range and 
  90.          time of the search.
  91.  
  92.          Valid output parameters are:  '*' to display the DSPSRCDIR 
  93.          report; and, '*Print' or '*List' to redirect the report to the 
  94.          printer.
  95.  
  96.  
  97.          IV.  How to Submit Job for wider searches.
  98.          
  99.          If you wish to perform a global search for source code member 
  100.          names, you should submit a job with the Display Source Code 
  101.          Directory command in order not to lock up your workstation. 
  102.          
  103.          For example, let us say you wished to find all the payroll 
  104.          source code files.  Let us assume that all payroll source 
  105.          code files are named with the prefix of 'PR' and that all the 
  106.          code is in 'QSRC' library.  The following figure (Fig. 2) 
  107.          describes the command you would use: 
  108.  
  109.          
  110.          SBMJOB JOB(MYJOB) RQSDTA('DSPSRCDIR TYPE(*ALL) MBR(PR*) + 
  111.                 FILE (*ALL.QSRC) OUTPUT(*PRINT)')
  112.          
  113.                                      Fig. 2 
  114.  
  115.  
  116.          IV.  Special Thanks.
  117.          
  118.          My special thanks goes to Bob Cozzi, whose article "Display 
  119.          Database Directory" in Vol. 5 No. 4 issue of Q38 Technical 
  120.          Journal motivated me to write DSPSRCDIR command. 
  121.  
  122.  
  123.          V.  Disclaimer.
  124.  
  125.          Shaw-Barton, Inc. or I, Joe Bolen, take no responsiblity for 
  126.          the failure of the DSPSRCDIR command or the loss of data 
  127.          media information as the result of its use.
  128.